PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager

InvalWindowRect

Adds a rectangle to a window's update region.

pascal OSStatus InvalWindowRect (
                     WindowPtr window,
                     const Rect *bounds);
window
A value of type WindowPtr . Pass a pointer to the window containing the rectangle that you wish to be updated.
bounds
A pointer to a structure of type Rect . Before calling InvalWindowRect , set this structure to specify, in local coordinates, a rectangle to be added to the window's update region.
function result
A result code. See Result Codes.
DISCUSSION

The InvalWindowRect function informs the Window Manager that an area of a window should be redrawn. The InvalWindowRect function is similar to the InvalRect function, but InvalWindowRect allows the window that it operates upon to be explicitly specified, instead of operating on the current graphics port, so InvalWindowRect does not require the graphics port to be set before its use. See Maintaining the Update Region for further discussion.

VERSION NOTES

Available with Mac OS 8.5 and later.

SEE ALSO

The function ValidWindowRect .

The function InvalWindowRgn .

© 1999 Apple Computer, Inc. – (Last Updated 18 March 99)